package com.xs.xsaishuaan.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.xs.xsaishuaan.model.dto.question.QuestionQueryRequest;
import com.xs.xsaishuaan.model.entity.Question;
import com.xs.xsaishuaan.model.entity.User;
import com.xs.xsaishuaan.model.vo.QuestionVO;

import javax.servlet.http.HttpServletRequest;
import java.util.List;

/**
 * 题目服务
 *
 * @author lambor
 */
public interface QuestionService extends IService<Question> {

    /**
     * 校验题目数据
     *
     * @param question 题目对象
     * @param add      是否为创建操作，true表示创建，false表示更新
     */
    void validQuestion(Question question, boolean add);

    /**
     * 获取查询条件包装器
     *
     * @param questionQueryRequest 题目查询请求参数
     * @return 查询条件包装器
     */
    QueryWrapper<Question> getQueryWrapper(QuestionQueryRequest questionQueryRequest);

    /**
     * 获取题目封装视图对象
     *
     * @param question 题目原始对象
     * @param request  HTTP请求对象
     * @return 题目视图对象
     */
    QuestionVO getQuestionVO(Question question, HttpServletRequest request);

    /**
     * 分页获取题目封装视图对象
     *
     * @param questionPage 题目分页对象
     * @param request      HTTP请求对象
     * @return 题目视图分页对象
     */
    Page<QuestionVO> getQuestionVOPage(Page<Question> questionPage, HttpServletRequest request);

    /**
     * 分页获取题目列表
     *
     * @param questionQueryRequest 题目查询请求参数
     * @return 题目分页对象
     */
    Page<Question> listQuestionByPage(QuestionQueryRequest questionQueryRequest);

    /**
     * 批量删除题目
     *
     * @param questionIdList 需要删除的题目ID列表
     */
    void batchDeleteQuestions(List<Long> questionIdList);

    /**
     * 获取题目封装（未登录用户版本）
     * 不包含答案等敏感信息
     *
     * @param question 原始题目对象
     * @param request  HTTP 请求
     * @return 脱敏后的题目VO
     */
    QuestionVO getPartialQuestionVO(Question question, HttpServletRequest request);

    /**
     * 从 Elasticsearch 查询题目
     *
     * @param questionQueryRequest 题目查询请求参数
     * @return 题目分页对象
     */
    Page<Question> searchFromEs(QuestionQueryRequest questionQueryRequest);
}
